home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ShareWare OnLine 2
/
ShareWare OnLine Volume 2 (CMS Software)(1993).iso
/
prog
/
suprman.zip
/
READ.ME
< prev
Wrap
Text File
|
1993-04-26
|
6KB
|
162 lines
SUPERMANual version 1.00
SUPERMANual is a program which will extract documentation out of your source
code which is documented using the enclosed CLIPPER.HDR header.
It is capable of creating the entire Users Manual with Table of Contents that
can be printed or edited with your word processor.
The file that is created is called MANUAL.DOC. This file is an ASCII file which
can be edited or printed.
Contents of this Zip are:
READ.ME This ASCII file
MANUAL.DOC The Manual for example.prg created by MANUAL.EXE
EXAMPLE.PRG A sample program commented for SUPERMANual
CLIPPER.HDR The Header file that needs to be placed throughout your source
code with user instruction for that section of your program.
MANUAL.EXE The SUPERMANual Program
MANUAL.DBF Configuration File
After you use this the first time, the following files will be created:
TXT.DBF The Manual Storage Database
TXT.NTX The Index for the TXT.DBF file
Here is what the header file looks like:
/*
$SUPERMAN$
$CHAPTER$
$SUBCHAPTER$
$HEADING$
$TXT$
$END$
*/
Here is how you would use this file.
/*
$SUPERMAN$ required
$CHAPTER$ up to 2 digits wide
2
$SUBCHAPTER$ up to 3 digits wide
1
$HEADING$ up to 74 chrs wide
Command Line Parameters
$TXT$ up to 80 chrs wide / Unlimited Length
You can bypass the input/output file screen by using the built-in command
line parameters.
Here is the usage:
FIX Infile OutFile [enter]
$END$ required
*/
Look in the example.prg for more info on how to add the .hdr info.
How to use SUPERMANual
----------------------
We will show you how to use SUPERMANual with the example.prg file that comes with this
demo.
After unzipping these files into a directory, you need to configure MANUAL.EXE.
This is done by typing MANUAL /c
you will see a screen that looks similar to this:
╒═══════════════════════════════════════════════════════════════════╕
│ SUPERMAN Config (c)1993 MoundSoft │
│ │
│ Assemble your User Manual from your Source Code │
│ │
│ MoundSoft 348 Poplar Avenue Moundsville, WV 26041 │
╘═══════════════════════════════════════════════════════════════════╛
────────────────────────────────────────────────────────────────────────────────
Enter the complete Program Name.
FIX Program - Version 1.0
────────────────────────────────────────────────────────────────────────────────
Enter the copyright owner name.
Michael Abadjiev CIS 71563,3312
────────────────────────────────────────────────────────────────────────────────
Enter up to a three line description.
FIX.EXE will search your CA/Clipper 5.x LIBS and convert them to
CA/Clipper 5.20 Libraries by replacing every occurrence of CLIPPER501 with
CLIPPER520, therefore making them work with CA/Clipper 5.20.
────────────────────────────────────────────────────────────────────────────────
Header : The FIX Program - Version 1.0
Footer : Copyright (c)1993 Michael Abadjiev
────────────────────────────────────────────────────────────────────────────────
After you press [enter] on the last field, your new info will be saved.
The next step is to run MANUAL on each one of your .prg files.
Since we are now just using the example.prg file, simply type:
MANUAL example [enter]
This will build a database of all of your headers and text for the manual.
If you had more than one .prg file, you would run this on each one.
Here is a list of the command line parameters.
usage: MANUAL filename Will add the [filename].prg text to the
current manual file. Use this format for
each of your .prg files for your appli-
cation to the txt.dbf file.
Do not add the file extension.
─────────────────────────────────────────────────────────
MANUAL filename /e the /e switch will empty the txt.dbf file so
you can start over.
Do not add the file extension.
─────────────────────────────────────────────────────────
MANUAL CREATE Will create the finished Manual that is ready
to print or ready for your word processor.
─────────────────────────────────────────────────────────
MANUAL /c To configure this manual.
─────────────────────────────────────────────────────────
After using MANUAL.EXE on each of your .prg's, it is time to write the manual to
an ASCII file. To do this, type:
MANUAL create
Before you know it, you will have a file called MANUAL.DOC in your directory,
ready for printing or word processing.
You can test your manual by typing:
TYPE MANUAL.DOC > PRN [enter]
This demo has two limitations. The first one is that it will only create 6
pages of your manual.
The second limitation is that it will not produce the table of contents.
The registered version does both plus has support for Laser Printers, Graphics
Chrs, self designed page header & page footer, and more...
╒═══════════════════════════════════════════════════════════════════╕
│ SUPERMANual DEMO (c)1993 MoundSoft │
│ Send $69 + $5 S&H to: │
│ MoundSoft 348 Poplar Avenue Moundsville, WV 26041 │
│ │
│ Create your User Manual from your Source Code │
│ The DEMO only creates the first 6 pages. │
│ │
╘═══════════════════════════════════════════════════════════════════╛